home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / fdca102.zip / FDCA.DOC next >
Text File  |  1993-04-01  |  18KB  |  424 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  13.  ▓▓▓▓▓▓▓▓▓▓▓▓┌─────────┐▓┌─────────┐▓▓┌─────────┐▓▓┌────────┐▓▓▓▓▓▓▓▓▓▓▓▓▓░░░
  14.  ▓▓▓▓▓▓▓▓▓▓▓▓└┐  ┌───┐ │▓└┐  ┌───┐ └┐▓│  ┌────┐ │▓▓│  ┌──┐  │▓▓▓▓▓▓▓▓▓▓▓▓▓░░░
  15.  ▓▓▓▓▓▓▓▓▓▓▓▓▓│  │▓▓▓└─┘▓▓│  │▓▓▓│  │▓│  │▓▓▓▓└─┘▓▓│  │▓▓│  │▓▓▓▓▓▓▓▓▓▓▓▓▓░░░
  16.  ▓▓▓▓▓▓▓▓▓▓▓▓▓│  └──┐▓▓▓▓▓│  │▓▓▓│  │▓│  │▓▓▓▓▓▓▓▓▓│  └──┘  │▓▓▓▓▓▓▓▓▓▓▓▓▓░░░
  17.  ▓▓▓▓▓▓▓▓▓▓▓▓▓│  ┌──┘▓▓▓▓▓│  │▓▓▓│  │▓│  │▓▓▓▓▓▓▓▓▓│  ┌──┐  │▓▓▓▓▓▓▓▓▓▓▓▓▓░░░
  18.  ▓▓▓▓▓▓▓▓▓▓▓▓▓│  │▓▓▓▓▓▓▓▓│  │▓▓▓│  │▓│  │▓▓▓▓┌─┐▓▓│  │▓▓│  │▓▓▓▓▓▓▓▓▓▓▓▓▓░░░
  19.  ▓▓▓▓▓▓▓▓▓▓▓▓┌┘  └┐▓▓▓▓▓▓┌┘  └───┘ ┌┘▓│  └────┘ │▓┌┘  └┐┌┘  └┐▓▓▓▓▓▓▓▓▓▓▓▓░░░
  20.  ▓▓▓▓▓▓▓▓▓▓▓▓└────┘▓▓▓▓▓▓└─────────┘▓▓└─────────┘▓└────┘└────┘▓▓▓▓▓▓▓▓▓▓▓▓░░░
  21.  ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░
  22.  ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░
  23.     ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  24.  
  25.  
  26.  
  27.                                  FDCA 1.02
  28.  
  29.                          FrontDoor Cost Accounting
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.            Software and documentation written by Clayton Mattatall
  54.                     Copyright (C) 1992, 1993 Clayton Mattatall
  55.                              All rights reserved
  56.  
  57.      1.0  What is FDCA?
  58.  
  59.      FrontDoor Cost Accounting, or FDCA for short, is a program to help users
  60.      of FrontDoor to analyze their costs involved with their mail/file
  61.      transfers from within the FrontDoor mailer.
  62.  
  63.      FDCA was first released in a public beta test on November 11, 1992 and is
  64.      now in it's second release with a new look, faster operation and some new
  65.      capabilities.
  66.  
  67.          *  You can now enter a start date, end date, or both.  What ever you
  68.             prefer. This allows you to keep extra long history files and still
  69.             be able to pull out info about one month, or however many days,
  70.             that you like.
  71.  
  72.          *  You can now get info on all node numbers as before or, just one
  73.             zone, just one net, just one node number, just one point, any zone
  74.             but one net in particular, etc.  This is one feature I know some
  75.             people will love because of its' extreme flexibility.
  76.  
  77.          *  New look (I think it looks better)
  78.  
  79.          *  Speed improvement.  Re-written in Turbo Pascal.
  80.  
  81.  
  82.      1.1  System Hardware and Software Requirements
  83.  
  84.          *  An IBM PC, XT, AT or compatible with hard disk.
  85.  
  86.          *  Microsoft MS-DOS or IBM PC-DOS version 3.00 or later. Version
  87.             3.30 or later is preferred.
  88.  
  89.             FDCA was successfully tested with DOS 5.0, QEMM 6.03, QEMM 6.02
  90.             DESQview 2.42, on a system equipped with an Intel 80386SX.
  91.  
  92.             A disk cache (especially one that can buffer disk writes, such
  93.             as Norton Cache or HyperDisk) can improve performance, but of
  94.             course it is not required. If you are not using a disk cache,
  95.             make sure that CONFIG.SYS contains a BUFFERS statement to
  96.             improve performance.
  97.  
  98.          *  FrontDoor history files
  99.  
  100.      1.2  License and Disclaimer
  101.  
  102.      "FDCA" refers to all executables and documentation as distributed in
  103.      the compressed file in which the package was released.
  104.  
  105.          *  FDCA is copyrighted material by Clayton Mattatall. It may
  106.             only be used in agreement with the conditions set out in this
  107.             license agreement.
  108.  
  109.          *  This version of FDCA is released as shareware.
  110.  
  111.             -  You may use the unregistered version of FDCA for an
  112.                evaluation period of 30 days. After this period you
  113.                MUST either register FDCA or stop using it.  See
  114.                registration information below.
  115.  
  116.             -  Registration is REQUIRED for commercial usage (in a
  117.                commercial environment, such as business, governmental
  118.                organization, association, school, foundation, or any other
  119.                form of juridical person, or any system where FDCA is
  120.                directly or indirectly used to make profit).
  121.  
  122.             -  Unregistered evaluation versions of FDCA may be distributed
  123.                freely provided no money or any other compensation is asked
  124.                or accepted without prior written permission from the author.
  125.  
  126.          *  Although care has been taken to write and test a program that
  127.             does what this document states, FDCA is provided as is, without
  128.             warranty or guarantee of any kind, either expressed or implied,
  129.             as to the fitness for a particular purpose or quality or
  130.             performance of this program, except that FDCA will occupy
  131.             disk space.
  132.  
  133.          *  In no event shall Clayton Mattatall be liable to you or anyone
  134.             else for any damages or cost, including, but not limited to,
  135.             any lost profits, lost savings or lost income which may result
  136.             from the use or inability to use FDCA.
  137.  
  138.          *  In no way is Clayton Mattatall obligated to you or anyone
  139.             else to provide future versions of, or support for FDCA.
  140.  
  141.          *  Clayton Mattatall reserves the right not to release future
  142.             shareware versions of FDCA, but switch to a commercial "buy
  143.             before you try" marketing concept instead.
  144.  
  145.          *  Your use of FDCA constitutes your agreement to this license
  146.             and disclaimer and your release of the author from any form of
  147.             liability or litigation.
  148.  
  149.      2.0  Starting the program
  150.  
  151.      To run FDCA, place the executable program in any directory that you
  152.      desire.  No configuration file is required and the software is not
  153.      directory or drive specific although it will use the FrontDoor environment
  154.      variable of FD if it is set.  If FDCA does find this variable set, it
  155.      will look for your FrontDoor history files in the directory pointed to by
  156.      this variable and will create it's output text file in the same directory.
  157.  
  158.  
  159.      2.1  Command line parameters
  160.  
  161.      There are four (4) command line parameters available to you.  They are
  162.      listed as follows:
  163.  
  164.         ?         -B         -E         -S
  165.  
  166.      Below is the screen displayed when you use the ? as a parameter ANYWHERE
  167.      on the command line.
  168.                                 -+-
  169.  
  170.         FDCA 1.02 ■ FrontDoor Cost Accounting ■ February 26, 1993
  171.         Copyright (C) 1992, 1993  Clayton Mattatall, All rights reserved
  172.  
  173.         Running under Desqview 2.42
  174.  
  175.         Registered to Clayton Mattatall, of InfoTech Online SuperBBS
  176.  
  177.         Optional command line parameters:
  178.  
  179.             -Bdd/mm/yy          dd/mm/yy is the date to start at.
  180.  
  181.             -Edd/mm/yy          dd/mm/yy is the date to end at.
  182.  
  183.             -Szone:net/node.point
  184.  
  185.               * may be used in place of zone, net, node, or point
  186.                 see documentation about the use of this variable.
  187.  
  188.         Any and all parameters are optional.  See documentation for more detail.
  189.  
  190.                                 -+-
  191.  
  192.      As you can see, FDCA will detect DesqView when running and will not use
  193.      direct screen writes if DesqView is detected.
  194.  
  195.      The command line parameters are explained below:
  196.  
  197.      -Bdd/mm/yy          dd/mm/yy is the date to start at.
  198.  
  199.          This is the date that you want FDCA to "B"egin calculating entries
  200.          at.
  201.  
  202.      -Edd/mm/yy          dd/mm/yy is the date to end at.
  203.  
  204.          This is the date that you want FDCA to "E"nd calculating entries
  205.          at.
  206.  
  207.      Here are some examples on how to use these two options:
  208.  
  209.      1.    FDCA102 -B01/02/93
  210.  
  211.            FDCA will read through your history files and grab all entries
  212.            dated February 1, 1993 to the current date and use those entries in
  213.            it's calculations.
  214.  
  215.      2.    FDCA102 -E31/01/93
  216.  
  217.            FDCA will read through your history files and grab all entries
  218.            from the first one found up to and including any dated January 31,
  219.            1993 and use those entries in it's calculations.
  220.  
  221.      3.    FDCA102 -B01/01/93 -E31/01/93
  222.  
  223.            FDCA will read through your history files and grab all entries
  224.            dated between January 1, 1993 and January 31, 1993 and use those
  225.            entries in it's calculations.
  226.  
  227.      As you can see, this can be a very powerful feature.  It will enable you
  228.      to match your costs in performing your mail/file transfers with your
  229.      phone bill.  To do this, you would set these date to match the billing
  230.      period that your phone company uses when issuing your bill.
  231.  
  232.      If for some reason you should enter a beginning date that is after your
  233.      ending date (we all make typo's sometime), FDCA will terminate with any
  234.      error message to this effect.
  235.  
  236.      The syntax for the third command line parameter is as follows:
  237.  
  238.      -Szone:net/node.point
  239.  
  240.      This parameter can get a little confusing so read carefully.  There are
  241.      many ways to use this and because of this I suggest reading this section
  242.      twice.
  243.  
  244.      Here is a straight forward example it's use -
  245.  
  246.         FDCA102 -S1:247/124         (that's my node number)
  247.  
  248.         Issuing this will result in FDCA reading through ALL the entries
  249.         found BUT only recording/calculating entries from/to node number
  250.         1:247/124.  Simple right? (so far)
  251.  
  252.         Ok.  Any of the four (4) numbers asked for with this parameter are
  253.         optional. (Well, kind of.  Now here's where it gets confusing.)
  254.  
  255.         You have the ability to "wildcard" any and all of the asked for
  256.         numbers.  To do this replace the number an asterisk. (*)
  257.         (leave off the brackets).  So, If you wanted to use only the entries
  258.         for net 247, you would use 1:247/* or just simply 1:247  .
  259.  
  260.         Any numbers that you do not enter to the right of any you do will be
  261.         replaced automatically with a *.  Here are some examples to explain
  262.         what I mean:
  263.  
  264.            -S1:247/124.*      Will list all points off of node 124
  265.                               This is functionally the same as entering
  266.                               1:247/124
  267.  
  268.            -S1:247/124.0      Will only grab the entries for that particular
  269.                               node.  NO POINTS.  Use this syntax if you are
  270.                               interested in ONE EXACT node.
  271.  
  272.            -S1:247/*          Will list all nodes in net 247 along with all
  273.                               points off of those nodes.
  274.  
  275.                               Functional equivalent  -S1:247
  276.  
  277.            -S1:*              Will grab all entries for zone 1 including all
  278.                               nets, nodes, and points.
  279.  
  280.                               Functional equivalent  -S1
  281.   
  282.         Now lets get fancy ! !
  283.  
  284.            -S1:*/0            Will grab all entries for zone 1, all nets
  285.                               within zone 1 but only the 0 node systems.
  286.                               Using this would enable you to see how much you
  287.                               have transferred to all the Net Coordinators you
  288.                               have called.
  289.  
  290.            -S*:70/*.0         Will grab all entries in ALL zones, net 70, all
  291.                               nodes, but NO points.  You may want to do this
  292.                               incase a network that you are in has a certain
  293.                               net that is used for a special interest group.
  294.  
  295.  
  296.         Well, if you are confused by this parameter then just don't use it.
  297.         OR (the BIG or), play around.  You won't hurt anything by doing so
  298.         other than your head trying to keep it straight how this option works.
  299.         All I can say is have fun with it!  I know I sure did.
  300.  
  301.  
  302.      The last parameter is the dreaded ?.  Yes, we all need it once in a while
  303.      so don't be scared to use it.  You may place it ANYWHERE on the
  304.      commandline and it will bring up the help screen that you saw above.
  305.  
  306.  
  307.      2.2  ErrorLevels
  308.  
  309.      When running FDCA, there is the possibility of it exiting with an
  310.      errorlevel.  They are as follows:
  311.  
  312.           254 - Tells you that for some reason it has detected that your
  313.                 key file has been modified or has been corrupted in some
  314.                 way.  You can contact me if you should encounter this error
  315.                 and I will try to help you determine what caused this and
  316.                 if necessary, will issue you a new keyfile.
  317.  
  318.                 Note - this only applies to either Registered users or to
  319.                        Beta test sites.
  320.  
  321.           253 - Caused by your system date not being set properly for the
  322.                 program to work properly.
  323.  
  324.  
  325.      3.0  Registration
  326.  
  327.      I would hope that anyone who uses this program beyond the trial period
  328.      will see it in themselves to send in the registration fees.  They are not
  329.      excessive and have been kept that way so that everyone should be able to
  330.      afford it.  Please fill in the ORDERFRM.DOC file enclosed within this
  331.      archive and send it to me at the following address:
  332.  
  333.                                 Clayton Mattatall
  334.                                 4-63 Pelham Road
  335.                                 St. Catharines, Ontario
  336.                                 CANADA      L2S 1R6
  337.  
  338.      along with enclosed payment.  Upon receipt, I will in turn create a key
  339.      file for you.  This file will be sent to you in the way you specify on
  340.      the registration form.
  341.  
  342.      3.1  History
  343.  
  344.      Version 1.02
  345.  
  346.           - Released February 26, 1993 to the public.
  347.           - Totally re-written in Turbo Pascal.
  348.           - Removed bug where last entry was not being put in the output file.
  349.           - Increased overall speed.
  350.           - Added registration key routines.
  351.           - Corrected some minor calculation problems.
  352.           - Added my address to the documentation so people that are kind
  353.             enough to send in the registration know where to send it.
  354.  
  355.      Version 1.01/ß-1
  356.  
  357.           - Released as a public Beta test to see if this program was really
  358.             of any use to anyone and if so, if there were any bugs reported.
  359.  
  360.  
  361.      4.0  Credits
  362.  
  363.      A very special "Thank You" and "Will you forgive me now?" goes out to
  364.      my girl, Roxane Gardner, who stood by me while I wrote this little
  365.      program and allowed me to still sleep in the house after ignoring her
  366.      for hours on end at times.          Thanks dear!
  367.  
  368.      I would personally like to thank each and everyone of the people
  369.      that helped/inspired me in this project:
  370.  
  371.      Cal Gardner      - This is the guy who had to sat and listened to me
  372.                         complain while I was re-writing this in Turbo Pascal.
  373.                         He told me I should learn it (you see it's what he
  374.                         writes in) so I put him though hell while I learned.
  375.                         I bet he'll be glad when I quit asking some of the
  376.                         stupid questions I did.  (Well smart to me but stupid
  377.                         to him)
  378.  
  379.      Dan Pressnell    - My first registered user!  Thanks Dan!  Also thanks
  380.                         for registering so many copies.  I hope Gary is
  381.                         enjoying his copy and the others that you have sent
  382.                         your registered versions to.       Thanks again!
  383.  
  384.      Les Lemke        - One of the major forces in me continuing this project
  385.                         putting out version 1.02.  Tell me something though,
  386.                         With a return address as a P.O. Box, How in the world
  387.                         did you get your PC in there? hehe Take Care Les and
  388.                         Thanks Guy!
  389.  
  390.      Jorge Mariano    - How dare you think of going to Binkley :-)  Hope you
  391.                         come back to FD if you do switch.  If not, you won't
  392.                         be able to use my version 1.02.   Cya!
  393.  
  394.      Keith Wineka     - Well you wanted to be of assistance and you were just
  395.                         by sending me that netmail.  It helped make me decide
  396.                         to put out another version.  If you still want to help,
  397.                         spread the program around and talk people into
  398.                         registering.  I need the cash to buy another system for
  399.                         my girl here since I spend so much time programming on
  400.                         this one. <g>                  Take Care!
  401.  
  402.      Richard Mcduffie - Like I said, terminal connections charges will have to
  403.                         wait for JoHo.  If he does implement them into the
  404.                         history files, then who knows, I may just add another
  405.                         option.                         Catch Ya!
  406.  
  407.  
  408.      Special thanks also go to Joaquim H. Homrighausen, for writing
  409.      FrontDoor and making it such a great piece of software.
  410.  
  411.      5.0  More legal stuff
  412.  
  413.      All brand and product names are Copyrighted (C) material, Trademarks
  414.      (tm) or Registered (R) Trademarks of their respective holders:
  415.  
  416.      Fido, FidoNet            Tom Jennings and Fido Software
  417.      FrontDoor, FM            Joaquim H. Homrighausen
  418.      FDCA                     Clayton Mattatall
  419.      QEMM, DESQview           Quarterdeck Office Systems, Inc.
  420.      Microsoft, MS-DOS        Microsoft Corporation
  421.      IBM, PC-DOS              International Business Machines Corporation
  422.      Turbo Pascal             Borland International
  423.  
  424.